<!DOCTYPE html>
<html lang="en">
<head>
	<meta charset="UTF-8">
	<meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
	<title>转换(transform)设置 | ElasticSearch 7.7 权威指南中文版</title>
	<meta name="keywords" content="ElasticSearch 权威指南中文版, elasticsearch 7, es7, 实时数据分析，实时数据检索" />
    <meta name="description" content="ElasticSearch 权威指南中文版, elasticsearch 7, es7, 实时数据分析，实时数据检索" />
    <!-- Give IE8 a fighting chance -->
    <!--[if lt IE 9]>
    <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
    <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
    <![endif]-->
	<link rel="stylesheet" type="text/css" href="../static/styles.css" />
	<script>
	var _link = 'transform-settings.html';
    </script>
</head>
<body>
<div class="main-container">
    <section id="content">
        <div class="content-wrapper">
            <section id="guide" lang="zh_cn">
                <div class="container">
                    <div class="row">
                        <div class="col-xs-12 col-sm-8 col-md-8 guide-section">
                            <div style="color:gray; word-break: break-all; font-size:12px;">原英文版地址: <a href="https://www.elastic.co/guide/en/elasticsearch/reference/7.7/transform-settings.html" rel="nofollow" target="_blank">https://www.elastic.co/guide/en/elasticsearch/reference/7.7/transform-settings.html</a>, 原文档版权归 www.elastic.co 所有<br/>本地英文版地址: <a href="../en/transform-settings.html" rel="nofollow" target="_blank">../en/transform-settings.html</a></div>
                        <!-- start body -->
                  <div class="page_header">
<strong>重要</strong>: 此版本不会发布额外的bug修复或文档更新。最新信息请参考 <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/index.html" rel="nofollow">当前版本文档</a>。
</div>
<div id="content">
<div class="breadcrumbs">
<span class="breadcrumb-link"><a href="index.html">Elasticsearch 权威指南 [7.7]</a></span>
»
<span class="breadcrumb-link"><a href="setup.html">安装和设置</a></span>
»
<span class="breadcrumb-link"><a href="settings.html">配置 Elasticsearch</a></span>
»
<span class="breadcrumb-node">转换(transform)设置</span>
</div>
<div class="navheader">
<span class="prev">
<a href="sql-settings.html">« SQL访问设置</a>
</span>
<span class="next">
<a href="modules-transport.html">传输(transport) »</a>
</span>
</div>
<div class="section xpack">
<div class="titlepage"><div><div>
<h2 class="title">
<a id="transform-settings"></a>转换(transform)设置
</h2>
</div></div></div>

<p>使用 <em>转换(transform)</em> 不需要配置任何设置。它是默认开启的。</p>
<p>
所有这些设置都可以添加到 <code class="literal">elasticsearch.yml</code> 配置文件中。
动态设置也可以使用 <a class="xref" href="cluster-update-settings.html" title="Cluster update settings API">集群更新设置 API</a> 来更新整个集群。
</p>
<div class="tip admon">
<div class="icon"></div>
<div class="admon_content">
<p>动态设置优先于 <code class="literal">elasticsearch.yml</code> 文件中的设置。</p>
</div>
</div>
<h4>
<a id="general-transform-settings"></a>常规转换设置
</h4>
<div class="variablelist">
<dl class="variablelist">
<dt>
<span class="term">
<code class="literal">node.transform</code>
</span>
</dt>
<dd>
<p>
设置为 <code class="literal">true</code> 以将节点标识为 <em>转换节点(transform node)</em>。
如果节点的  <code class="literal">node.data</code> 或 <code class="literal">xpack.transform.enabled</code> 是 <code class="literal">false</code>，则该设置默认为 <code class="literal">false</code>；
否则，默认值为 <code class="literal">true</code>。
</p>
<p>
如果在 <code class="literal">elasticsearch.yml</code> 配置文件中设置为 <code class="literal">false</code>， 该该节点无法运行 <em>转换</em>。

如果设置为 <code class="literal">true</code>，但是 <code class="literal">xpack.transform.enabled</code> 被设置为 <code class="literal">false</code>，则 <code class="literal">node.transform</code> 设置会被忽略，这也意味着该该节点无法运行 <em>转换</em>。

如果要运行转换，集群中必须且至少要有一个转换节点。
</p>
<div class="important admon">
<div class="icon"></div>
<div class="admon_content">
<p>
建议使用 <code class="literal">node.transform</code> 设置将转换的执行限制在某些节点上，而不是使用 <code class="literal">xpack.transform.enabled</code>。
在专用的协调节点或专用的主节点上，禁用 node.transform 角色。
</p>
</div>
</div>
</dd>
<dt>
<span class="term">
<code class="literal">xpack.transform.enabled</code>
</span>
</dt>
<dd>
<p>
设置为 <code class="literal">true</code> (默认值) 以在节点上启用转换。
</p>
<p>
如果在 <code class="literal">elasticsearch.yml</code> 中设置为 <code class="literal">false</code> ，则该节点上的 转换API 会被禁用。

因此，该节点不能启动或管理转换，也不能接收与 转换API 相关的传输(内部的)通信请求。

如果该节点是 协调节点<span class="remark">(coordinating node)</span>，来自客户端(包括Kibana)的转换请求也会失败。
</p>
<div class="important admon">
<div class="icon"></div>
<div class="admon_content">
<p>
如果你想在集群中使用转换功能，推荐在所有节点上设置 <code class="literal">xpack.transform.enabled</code> 为 <code class="literal">true</code>。
这是默认行为。
至少，必须在所有<span title="master-eligible nodes">符合主节点条件的节点</span>和所有数据节点上启用它。
如果你想在客户端 或 Kibana 中使用转换功能，必须在所有的 协调节点<span class="remark">(coordinating node)</span> 上启用它。
</p>
</div>
</div>
</dd>
<dt>
<span class="term">
<code class="literal">xpack.transform.num_transform_failure_retries</code> (<a class="xref" href="cluster-update-settings.html" title="Cluster update settings API">动态</a>)
</span>
</dt>
<dd>
转换遇到非致命错误时重试的次数。
一旦达到重试次数限制，转换任务将被标记为 <code class="literal">failed</code>。
默认值为 <code class="literal">10</code>，有效最小值为 <code class="literal">0</code>，最大值为 <code class="literal">100</code>。
如果转换已经在运行，则必须重新启动才能使用更改后的设置。
</dd>
</dl>
</div>
</div>
<div class="navfooter">
<span class="prev">
<a href="sql-settings.html">« SQL访问设置</a>
</span>
<span class="next">
<a href="modules-transport.html">传输(transport) »</a>
</span>
</div>
</div>

                  <!-- end body -->
                        </div>
                        <div class="col-xs-12 col-sm-4 col-md-4" id="right_col">
                        
                        </div>
                    </div>
                </div>
            </section>
        </div>
    </section>
</div>
<script src="../static/cn.js"></script>
</body>
</html>